5.4.8: Hint and Error Details

These options work in conjunction with the Page Properties. The Perform Client Side Validation on this Field? option allows control over validation of data, prior to submission. In addition to the true and false options for validation, a dynamic option is available to enable the determination of whether to validate or not to be finalised at runtime. Data bindings, pointing to the information required to make this decision, will be required. Note: These validation settings against individual controls is only activated if the Validate option on the appropriate submission action, within the Events tab, is ticked (Requires server controllers). Enabling the Create Message Container? check box creates a container beside the field, to contain any error icon or other error message text. This is generally switched on for all editable fields. This is required for the Local Error Message functionality from the Page Properties tab. Once this has been selected, a Show hint message? can be specified by ticking the checkbox. The hint message will override the standard error messages for a field. The Hint Container Styling allows CSS to be applied to the hint message container. The Hint Message text area is provided for the entry of hint messages. The Error Display Method setting on the Page Details tab determines how the hint is displayed (e.g. as page text or in a tooltip). The Show server message? checkbox allows you to associate this field with messages from the server. If this is selected, some data bindings will need to be provided to locate the message in the data. If this option is selected, and matching data is present in the data, the message will be shown next to the field, overriding any hint that may have been specified. Any client side validation errors that occur once the page has loaded will override any server message specified. The Retain through client side validation checkbox sets what should be shown after the client-side validation problem has been fixed. If ticked, the server message will be re-shown, otherwise the hint will be shown if present. The Message Styling can be used to style the server message. Table of Frequently Used Hint and Error Option Styles

Class Name	Notes on Use
hintIcon	Defines an image, indicating the presence of a hint, which is revealed on hover.
errorIcon	Defines an image, which indicates the presence of errors. This style is linked to the settings on the Page Details for the Error Display Method, to determine how errors should be displayed, either as an icon/message tooltip or error message text.
errorMessageText	Defines the colour of the Error Message text. This style is linked to the settings on the Page Properties tab for the Error Display Method, to determine how errors should be displayed, either as an icon/message tooltip or error message text.